home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _discutils / discutils / _discspace / _help < prev    next >
Encoding:
Text File  |  1994-02-11  |  3.9 KB  |  87 lines
  1. DiscSpace 1.04 (10-Feb-1994)
  2.  
  3. Purpose: display of graphical disc usage statistics for directories
  4. Author:  Martin Wuerthner
  5.          Jahnstrasse 18
  6.          71116 Gaertringen
  7.          (Germany)
  8.          e-mail: wuerthne@minnie.informatik.uni-stuttgart.de
  9. Runs under: RISC OS 2 or higher
  10.             supports RISC OS 3 image files and DragASprite
  11. Status: FREEWARE (see below)
  12.  
  13. Have you ever wondered where all the free space on your hard disc has
  14. gone? Do you want to know which directories consume most of your hard
  15. disc space without having to count each directory using the filer?
  16.  
  17. This application shows a diagram of disc usage, displaying a bar for
  18. each directory. The whole directory tree is cached so you can open
  19. subdirectories similar to using a filer window.
  20.  
  21. How to use it:
  22. --------------
  23.  
  24. The main menu item 'Count' leads to a standard RISC OS save box. Drag
  25. the 'filer window icon' to the directory you are interested in (e.g.
  26. the root directory of a drive).
  27.  DiscSpace scans the directory and all its subdirectories displaying
  28. some kind of FilerAction window (offering the menu options 'Faster'
  29. and 'Verbose' like the real FilerAction window). Note that counting
  30. may take some time if the chosen directory is a top-level one.
  31.  
  32. Having finished the 'Count' operation, DiscSpace displays a window
  33. which shows a 'Total' bar for the whole directory and a bar for each
  34. subdirectory indicating how much disc space it consumes. By
  35. double-clicking on a subdirectory, it is opened and the window is
  36. replaced by a display of the corresponding subdirectory. By chosing
  37. 'Open parent' from the menu or by Adjust-clicking on the Close icon,
  38. you can go up one level in the directoy tree (but no further up if yor
  39. are at your starting directory).
  40. By default files are not shown in the window. Instead, there is one
  41. item which shows how much space all the files in the directory consume
  42. together. If you double-click on this item or choose 'Show files' from
  43. the menu, this item is replaced by one item for each file in the
  44. directory. Double-clicking on any of these file icons or choosing
  45. 'Show Files' again switches back to the original display mode. By
  46. choosing 'Open filer' from the menu, a filer window on the currently
  47. displayed directory is opened.
  48. Choose 'Rescan' from the menu to have the directory scanned again
  49. (useful if you have deleted objects in the meantime).
  50.  
  51. The main menu item 'Images' determines whether DiscSpace also scans
  52. the directory trees of image files (DOSDisc files or archives when
  53. used with !SparkFS). If it is not ticked, images are treated as files.
  54. The displayed size of an image file is always the size of the file
  55. (not the sum of the sizes of the objects inside the image). So for a
  56. DOSDisc image, the overall size usually differs from the sum of the
  57. sizes of the objects inside (as there may be unused space inside the
  58. image).
  59.  
  60.  
  61. DiscSpace uses outline fonts wherever possible (i.e. for all icons
  62. and menus). If you do not want this feature or if your version of the
  63. WindowManager already uses outline fonts instead of the system font,
  64. you may switch it off by commenting out the following line in the !Run
  65. file:
  66.   Set DiscSpace$UseFont TRUE
  67. or by setting the variable to FALSE.
  68.  
  69. You may change the font to be used and its size by modifying the
  70. lines:
  71.   Set DiscSpace$Font ...
  72.   SetEval DiscSpace$FontWidth ...
  73.   SetEval DiscSpace$FontHeight ...
  74. to suit your own taste. Note that if the font is not found, the
  75. application reverts to using the system font.
  76.  
  77. History:
  78.   version 1.03 (05-Feb-1994): first version sent to Hensa
  79.   version 1.04 (10-Feb-1994): fixed bug:
  80.                               Rescan took the currently displayed directory
  81.                               as starting directory for the scan instead of
  82.                               the previous starting directory
  83.  
  84. This application is FREEWARE, i.e. it may be copied freely provided
  85. that all files are distributed together and that none of them is
  86. changed. Distribution is only allowed if it is not sold for profit.
  87.